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BASIC CONCEPTS 
The purpose of this section is twofold: 
ae To define the terms most frequently used in this document. 


be To descr ibe the actions of OMSI{ in areas where the DASODL 
description tnteracts with other components of the system. 


RELATED DOCUMENTATION 


Name Number 
OMSII Audit and Recovery P.S.e 2219 0532 


OMSII Reorganization P.S. 2219 95490 
DATA SASE DEFINITION 


Basic Entities 


A data base described in DASDL consists of data ttems» data sets» 


and sets. A data item 1s a field which contains varying data 
values. It is the smallest named container of information in the 


data base. Data items may be of various types such as alpha or 


packed decimal. 


Related data items are organized into data records which reside 


in data sets. A data set is similar to a traditionat data 
processing file» except that the data management system handles. 
the mechanics of space allocations record location and references 
(pointers) to other files. Any particular data record is said to 
fe a member of the data set 1t 15 In. | 


A set is a collection of references to records in a data set. It 
provides a specialized access to that data set. It may» for 


example» provide efficient ordered access by an item tn the data 


set; or it may select onty certain members of the data set» 


based on a stated condition. Mcre than one set may be apptied to 
any wiven data set. Each set may include a reference to every 


member of the data set» or it may include references to only 


selected members. If it contains a reference to every membere it 


is called a spanning sets if tt contains only setected membersr | 


at is caited a subset. 


[<< 
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ALi spanning sets are automatically maintainec hy. the data 
management system. Whenever a record is added to or deleted from 
the data set» OMSII wilt perform a corresponding action for each 
spanning set. Subsets may be etther automatic or manual. If the 
condition for tncluston is specified in DASOL» then the set is 
automatically maintained. If the condition is not specifieds — 
then the application programs must insert and remove entries in 
the set. : 


In DASDL» data sets and sets are both called structures. Att 
structure names must he unique. Item names within a data set 
must be unique. However» items which are used as keys must be 


untque within the data base. 


Eabedded structures 


Many data relationships can be represented by a hierarchys or 
tree-structure. In DASDL these organizations can be represented 
by including a data set among the items of a data record. If a 
data set does contain another data set as an ttemp then the 
contained data set is called an embedded data set» and the data 
record tn which it 1s declared is called the owner or master of 
the embedded structure. Any number of embedded records may be 
under each master. 4 | 


It is also possible to include sets as items in a data record. 
As with data sets» such items are called embedded. Most 
coamontys» such sets apply to data sets within the same master» 
but they may also apply to other data sets. } 


If a structure is not embedded in any data set» then it is said 


to be disjoint. 


The term "master" refers to a record of the data set in which a 
particular structure is emtedéedj Sometimes tit ts useful to tatk 
about not only the master structure » but also the master's. 


masters the master's master's master,» and so forth. The tera 
ancestor is used to refer to any of those structurese up to the 


disjcint master. 


Ls 
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Manual References 


Some applications cannot be represented as hierarchies. For such 
applications» it may be necessary for a data record to refer to 
another data record without regard to any tree-like structure. 
Such a reference might te to another record of the same data set» 
or to a record of another disjoint data set. It can be a member 
of a manual embedded subset. Manual references provide a network 
Capability for describing data relationships. They are 
maintained by the apptication program using a speciat assignment. 
syntax. 


Access Characteristics Which Affect Programs 


There are three logical classes of data retrieval» each 
represented by one or more OMSII structure types. In general, 
changing the type of structure within one access class will not 
affect application programs,» but changing between classes may. 


ae Unkeyed Access 


In an unkeyed access» data records tay not be retrieved in 
any special order. The data set structures which are in 
this class are standard and unordered; the sets are 
unordered tltists. The application program should not infer 
any togicat order from the results of "find next" on such an 
access# however» atl records in the structure wilt be found 
exactly once. a | 7 


be Keyed Sequentiat Access 


In sequential access» records may be retrieveda in order by 
the key specified in DASDL. They may also be retrieved by 

specifying a particular value desired for that key. The set 
structures in this class are index sequertiats» crdered tist» 
and access to ordered data sets. The appticatiton program 
may depend on the fact that a "find next” operation wilt 
locate the next record according to the sequencing specified 
in the key. ee 


Ce Keyed Random Access 


In a random accesses records may be retrieved by specifying a 
particular value desired. Sertal access is not possible 
with this tyoe of set structure... The set structure in this 
class is index random. 
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SYNIAX DIAGRAMS | 


The syntax presented in the figures and exptanations that follow 
conform to railroad syntax as presented in software 


specifications released ay Software Decumentation at the Santa 
Barbara Plant. 


The main line of development is from left to right» down on the 
left and up on the” right. The beginning of the syntax is 
represented by one arrow (>) and is followed to its termination 
point €#). Continuation lines are indicated by double arrows 
(>>). Untess otherwise noted» optional entries are expected by 
the program in any order. Variabtes are presented in lower case» 
enclosed in trackets (<>). Upper case entries are required 
syntax... A bridge indicated by (/n\) shows the maximum number of 
times the Line may be crossed. A bridge indicated by (/n«\) 
shows the minimum number of times that the line must be crossed. 


ABBREVIATIONS 


Variables may be abbreviateds the followtng abbreviations have 
been used in this document: : 


Variable Abbreviation. 
attribute _ attr 
character char 
description. desc 
identifier | 4d 
integer. | int 

parameter ' param 
specification spec 
statement stmt 


Syntactic Entities 


<identifier> An identi fier consists of uppercase 
| alphanumeric characters and single embedded © 
hyphens. The first character must be an. 

atpha character. The maxit@#um number of 


characters allowed is 17» and the identifier 
must not cross card boundaries. | 
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Legal: —ABC-2 


XX X=KX X 
YZ 


Itbegat: 30E 


<literals> 


<alpha literals> 


XYZ- 
“MN 
abc 


A literal can be either alpha (a string. of 
characters)>, numeric €a string of digits)» 
or Hex Ca string of hexadecimal digits). 


Alpha literals must begin ana end with a 
quote character. They may be continued on 
subsequent records. The first non-tlank 
character of the continuation record must be 
a quote {(") and is not considered to te a 
part of the alpha literal. 


In order tec prevent excessive blanks from 
being placed in the dictionary § fite, data 
base comments may be continued on subsequent 
records tn the following manner. A quoted 
string is terminated by a quote. on the 
current record. If alt subsequent 
characters on. the record are blank and the 
first non-ctlank character of the subsequent 
record is a quotes then the previous string 
is concatenated with the current string and 
storec in the dictionary file. 


A quote may be placed in a quoted string by 
placing quotes adjacent to each other. 


Input: "Here is how to put a "™* in a string." 


Produces: Here is how to put a“ in a string. | 


A null string is represented by "". 


If onty blanks separate two strings» then 


they will be concatenated... 


<numeric. literals> 


Inputs —  "ABC™ “DEF” 
Produces: ABCDEF ae 
A numeric titeral can be of two types. An 
unsigned integer consists of a string of 
digits not crossing a card boundary. “An 


unsigned real is an unsigneac integer with a 


mt 
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decimal point at the ceginnings the eng» or 


in the middle. It also cannot cross a card 
boundary. Exponential notation is not — 
allowed. Ss | 
Unsigned integer: — 3894651 
Unsigned real: 2 387 
i | 1.245 
681. 
1.9 
7.9 


A hex literal must begin and ena with an "4" 


character. ALl intervering characters must 


be hexadecimal digitss ieee» Or 1» 2» Js 4s» 


Se 6 » 7» §68» 9> A» Be Co» Oe E and Fe Hex 


literals are an alternate method of 
specifying a character string and may be 
used in ine Same manner as ane literals. 


A hex Literal must have an even number of 
hex digits. A hex Literal may not cross — 


card toundaries. 


Examples: 


ae ALPHAC7) INITIALVALUE IS a1s0coooa "VAL"? 
bp. ALPHAC1) INITIALVALUE IS 2822 
c. ALPHAC3) INITIALVALUE IS aF0a. 2819 aF2as 


A file name may be of the form: 


ae <multifile id> | | 

b. <multifile id>/<file iar. 

ce <family name>/<multifile id>/ 

d. <family name>/<mnultifile id>/<file. Ade, 


‘The <family name>» <multifile id> and <file 


id> way be specified as identifiers or as 
atpha Literals. | : 


aed 
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RECOVERABILITY 
Types of Failure 

A processing faiture such as a Clear/Start may interruct a 
Logical update to the data base. For example» a data record may 
have been inserted into a cata set tut not inte one of its 
automatic sets. To recover data base integrity after such a 


failures it is necessary to preserve tefore igages so _ that 
partial operations can be tacked out. 


A storage failures on the other hands implies that previously 
good data has deteriorated. Such fatlures are usuatly detected 
by hardware parity checks» though in some cases they are. 
determined programmaticalty. Storage failures require a backup 
copy of the data area while it was still sound and a means to 
reconstruct the changes made since that dump.  Normaltys 
reconstruction is based on the audit trail maintained by the data 
management system» but ir some cases an installation may prefer 
to rerun its application programs. = 


Augit Trail 


The data management system maintains an audit file whenever the 
audit option 1s set in OASDL. This file records “hbefore™ and 
“after™ images of the data» in an abbreviated form when possible. 
No change 1s written to disk until the corresponding change is 
successfully written to the audit. . > 


If a processing faiture should occur» the “*before™ images are 
used to back out the partially completed operations. "After*® 
images are used also» to update any good data which had not been 
written to disk at the time of the failure. 


If a storage failure should oecur» the after images are used to 


bring some previous copy of the data up-to-date. When applying — 


after images» the data management system must coordinate the 
audit with the state of the data base at the time it was dumped. 


For more detail on this subject see P.S. 2212 547C. 


408 
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Iransactions 
A logical update to the data tase may contain wore than one 
primitive data management operation. For example, an update 
might consist of deleting a record from one data set and entering 
tit in altered form into another. DMSIT allows the application 
program to group such operations into a logical update or 
transaction. The data management recovery routines are 
transactton-oriented and always recover to a time uhen no partial 
transactions are reflected in the data base. A Clear/Start = may 
Interrupt aie transaction; so may abnormal termination of a 
program which was in the middle of a transaction. In either 
case» if audit was specified in DASDL» the DMSII reccvery 


routines wilt back up the data base to a “clean” point such that 
no partial transactions are reflected in the data hase. 


Restart Program Inforgation 


The application program must reprocess any transaction which was 


interrupted because of a processing failure such as a 
Clear/Start. To assist the application program in restarting» 
OMSII witt record restart information of the programmer's 


choosing. If a failure cccurs» the recovery routines will insure 
that the information corresponding to the tast good transaction 
for which the restart area was audited is in a special data set 
called the restart data sete. Using this informations the program 
can restart at the point to which the data base was recovered. | 


The program can detect that restart is necessarys if: 
ae It discovers that a Clear/Start has occurred; 


b. It discovers that another program caused some of its 
transactions to be aborted, 


“Cs It ts told py some manual method» as when reprocessing is 
needed after a storage failure. , | 
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MULIIPROGRAMMING 


Locking yersus Ihcoughput 


One of the most important design goals of CMSII is high 
throughput. To help achieve this goal, a high degree of 
parallelism is provided for in processing against the database. 
The locking strategy helps provide this parallelisa. 


It has been observed that a typical update operation against a 
database (iee.» a transaction) invotves a relatively smalt number 
of operations and records. In order to provide for the integrity 
of this set of changes in a qgultiprogramming environment» some 


method of locking must be provided. Locking too many resources 
at one time decreases the possibility of oparaltelisa and» 
therefore» decreases potential throughput. Locking too few 


resources results in unnecessary overhead and. inconventence to 
the user. DMSII balances this tradeoff by providing recora level 
locking. Providing reccrd tevel locking and allowing alt user 
programs to access the database concurrently provides a good 
compromise between locking too much at once or too little. 


Aborting Iransactions 


The only lock that persists for tonger than the course cf an 
individual database operation (eege» STORE) ts the lock a user 
may place on an tndividual record of a dataset. Specifically» 
index tables are not tocked except during the course cf a single 
database operation. Locking index tables (for exagpler until the 


end of a transaction) woutd provide the pcssibility of 
independence of transactions to the point that the tast 
transaction of a single program could be backed out without — 
affecting any other program» but the price paid in toss of 


potential paraltellism is much too great. 


Unlocking index tables as soor as possible», on the other hands 


allows maximum paraitlelisa, but causes all programs to be 
affected if the last transaction of any one of. them must he 
backed out. When aborting a transaction» atl transactions must 


ke backed out until a point is reached at which no program was in 


the transaction state. This Situation maximizes. total 
throughput» because aborting transactions is an unusual case. 
The normal case is that no transactions are abortec. In general, 
maximum total throughput is achieved when the normal case is 
optimized» even at the expense of extra overhead in abnormal 


cases. 


_ Because transactions in progress are allowed to complete before 
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the abort process commences-s exception processing is minimized. | 
The only verbs at which the abort exception need te handled by 
user programs are BEGINTRANSACTICN> ENOTRANSACTION and CLOSE. 


Deadlock — 


Kecord tlevel tlocking titntroduces the possibility ot deadtock. 
Consider the following sequence of events: | | 


Program A locks record 1. Program 8 locks record 2. Program A 
tries to lock record 2, but since program B already has it 
locked» program A is blocked (temporarity suspended). Program B 
tries to lock record 1 (which program A already has tocked). I f 
program 8 is blockea at this points the two programs are 
deadlocked or in a deadly embrace. They are in a circular wait» 
each waiting on the other. | Ceadlock is a circular waiting 
situation with any number cf orecesses involved such that none of 
the processes can make any progress. | 


Besides deadtiocks involving locked records» deadlocks can. cccur. 
Involving sync points and locked records. For examples» program A 
enters transaction state (by executing  BEGINTRANSACTION). 
Program 8 leaves transaction state (by executing ENDTRANSACTICN)» 


causing a syncpoint to be pending. Program 8 then locks record X 


and executes BEGINTRANSACTION. Since a syncpocint is pending» 
program 6 is blocked at BEGINTRANSACTION. Program A now tries to 
lock record X» which program 8 has Locked. [If program A is 
blocked» waiting for a records» the two procrams wilt be 
deadlocked because the syncpotnt that program B 15 waiting for 
cannot occur until program A finishes tts transaction. 


Internal to the access routines of OMSII» canonicat tocking 
orders and judicious use of.the control state are used to avoid 
the problem of deadlock. If any pair of tocks is atways  tocked 
in Cat most) one arder anc never in the reverse order» deadtock 
is taposstble. It is impossible for OMSII to try to tmpose a- 
canonical tocking order for the user programs to use in tlocking 
records. The access routines detect deadtock just before it 1s 


about to occur. Instead» a process is selected from among those 


which woula have been tnvolved tn the circular wait. That 
process unlocks all the records it has tocked in the database. 
It then returns a deadtock exception to the user program. 


The process chosen for the deadlock exception ts chosen so that 


progress iS guaranteed. Among those processes which would be 
involved in the circular watt» the one process with the tlowest. 


oriority is chosen. As the result of a deaatock exception» a 


precess is guaranteed that all its records are freed» but whether 
or not the process is in the transaction state is unaffected. 
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Only tocked records and sync points are considered by the 
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deadlock analysis of DMSII. ALltL other sources of waits are. 


ignored in the analysis» and it is the user's responsibility to 
see that deadlocks involving cther resources don't occur. If any 
program in the transaction state is delayed (for any reason) tong 
enough» it will eventually be time for a sync point» and from. 
that time One atl new transactions wilt tbe htocked at 
BEGINTRANSACTION until the delayed program finishes its. 
transaction. | | 


Hhen a program gets a deadlock exception» the access routines do 
not cause an aborts because the program may not yet have made any 
changes. In fact» when posstbttle» the best way for user programs 
to be written is to lock all records involved in the transaction 
before making any changes. If any deacdtock exceptions are 
encountered» handling them 13 a siaple matter of branching back 
to the beginning of tLocking the records. If the records are 
locked before HKEGINTRANSACTION is executede then even a deadtock 
exception on BEGINTRANSACTION may be handled in this way. 


Consistency 


Every database has a set of consistency constraints. These are 
normaliy not written down anywhere» but their exitstence 1s real 


muitiprogramming against a database 15 that transaction. 
processing routines which preserve these consistency constraints 
when run alone no tonger necessarity > preserve them when run — 
concurrently. | | a 


As a simple example» consider the consistency constraint that a. 
data item A of record Ril must be equal to data item & of record 
R2. The following two transaction precessing routines (Cin ‘pseudo 
code) preserve this constraint when they are run Beene 


LOCK ki | | LOCK R1 

A t= A * 2 | A := A + 100 
STORE R1 | STQRE R1 
FREE Ri. | FREE Ri 

LOCK R2 LOCK R2 

B 3:= B * 2 B := B + 10C 
STORE R2 STCRE R2 
FREE RQ FREE R2 


However» when they are run concurrently» they may ocr may not 
preserve the consistency constraint that A=B. For example» the 
following execution order guarantees that A 1s unequal to 8 upon 
completion if A=B initially» no matter what the tnitial value of 


at 
al 
a 
ef 
cal 
: 
i 
an 
e 


: 


nevertheless. A phenomenon which is introduced by _ 
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LOCK Fl 


A t= A-* Z 
STORE R1- 
FREE &1 
STQRE Ril 
FREE Ril 
LOCK R2 
B := B + 1900 
STCRE R2 
FREE R2 
LOCK R2 
B >= B * 2 
STORE R2 
FREE R2 


It is the responsibility of the user programs to use the record 
locking capabitity of CMSII to maintain consistency in a 
multiprogramming environment. Sefore suggesting how this might 
be done» it is appropriate to discuss a problem which arises in 
the multiprogramming environment because of audit and recovery. 


Reproducibility 


The transactions which are backed out by OmMS!II recovery are 
normally reprocessed. However, in a multiprogramming. 
environment» reproducing the same result obtained for these 
transactions before the recavery is ae oroblem. This 1s) 
especially true with an ontine database. Although batch 


processing against a database can often he crganizea such that 
each section of the database is updated in a singte threaded 
mode» this is normally not feasible for an online database due to 
the inadequate throughput which would result. 


As an example» consider an online banking database. Suppose a 
deposit to an account is made» and then shortly afterwards a 
withdrawal is made so targe that the deposit ts needed to cover 
it. After these transactions are processed» a recovery occurse 
and these transactions atong with others must be reprocessed. It 
would not be acceptable to cause an overdraft just because the 
transactions happened ta te rerun in a different order. 


Untess precautions are taken by the user application programs ine 
what record tocking conventions are followed» there may not be 
any ways» even single threading the update in rerun modes. which 
PSO TOnNeS a. ealkee previous results eaeeue yay exactly the same. wocare 
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routines are used and that they do not make a distinction between 
normal mode and rerun wmode). The user programs should use the 


record locking facilities of CMSII to control the marner in which 


concurrent transaction processing routines are interleaved. 


Miscellaneous Locking Considerations 


FIND does not cause the record retrieved to be locked. FINO 


should always be used with care» because it does not protect the 
results of any decistons made on the record retrieved. "<9 


LOCK (MODIFY) obtains the record exctusivety as far as other 
LOCKers are concerned» but a FIND can retrieve the records. even 
if it is LOCKed. | | 


When the record in the user work area is changed because of a 


FIND» LOCK» or DELETE» an implicit FREE on the previous current 


record is performed (if there was a previous current record and _ 


it was tocked?). 


STGRE does not free the record that was just changed or created. 


This aids in making a consistent set of changes to a collection 
of records during a transaction. | 


ENDOTRANSACTION automatically frees all records the process has 
tocked tn the database invotved. This helps make transactions 
independent and tends to help avoid starvation. ~~ 


‘Progragming Iransaction Routines 


A good programaning strategy in a multiprogramming environment 
should achieve the following goals: 


simplicity 

effictency 

high total throughput | 

preservation of consistency constraints 
reproducibility during rerun mode > 


Assume that it is never necessary to tock more than a small fixed 
nuaber of records. Then the following strategy may be used. 


Step 0: Obtain all necessary non~database input information 
7 needed for this transaction. 


“Step 1: LOCK alt records involved in the transaction. This 
_ includes even those records which are retrieved but not 
altered. FIND is not used at all. If any deadlock 
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“exceptions: are encountered» branch to the beginning of 
this step. | . 


. Step 2: Execute BEGINTRANSACTION. If a deadlock exception is 
encountered» branch to the beginning of Step 1. 


Step 3: Alt transactions at this point are independent of each 
- others tecause they have disjoint collections of records 
locked. Advantage can be taken of this fact for 
reproducibility. One possibility is to write the input. 
data for this transaction to a global seriat transaction 
history file. After a recovery» the backed out 
tansactions would be resubmitted from this file and 
processed ina single threaded fashion. # The result of 
this reprocessing should reproduce the previous results 
of each transaction exactly. The transaction routines 
need not be aware of whether or not they are in rerun 
mode. | 


Step 4: Perform the database updates and execute ENCTRANSACTION. 


Do not free any records. Let ENDTRANSACTION free att. 
flocked records. | . 


The amount of processing cone in the transaction state should be 
minimized in order to avoid excessive synchronizaticn delay at 


Sync point time. Special care should be taken to’ avoid 
potentially tong waits» such as file opens» watting for datacoma 
inputs |= etcCe>» in the transaction state. © One advantage of the 


above strategy is the elimination of potentially long waits on 
locked records tn the transaction state. 


GCne possible problem with the above strategy is the existence of 
bottleneck records» i.@e» records that must be locked by many 
different transactions» because they contain totals which must be 
updateds etc. The probles with such records is that in order to. 
avoid a tocking bottleneck they must be kept locked for as short 
a time as possible. 


The above strategy may be modified for such records as follows: 


Instead of locking all records before BEGINTRANSACTION» tCLock all 
except the bottleneck records. Define a canonical tocking crder 
such that they may be locked after REGINTRANSACTICAN is executed 
without causing any deadtocks. The bottleneck records are alt 
locked in transaction state» updated» and immediately freed. The 
point of independence of concurrent transactions is then between 
the LOCK and the FREE of the innermost bottleneck. record. 


In the modified strategy as welt as the original strategy» FIND 
is not used»s only LOCK. Furthermore» in both strategies» once a 
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record has been freed» no more records are locked» and the point 
of independence of concurrent transactions is anywhere between | 
the Last lock (Cor BEGINTRANSACTION) and the first FREE. Thus» 
both strategies may be divided tnto two phases. During the first 
phase» records may be locked but not freed» and during the second 
phase records may be. freed but not locked» and the point of 
independence is anywhere between the two phases. a > 


This two phase technique has several important properties. I f 
all transactions are two phase tut otherwise arbitrary» then any 
consistency constraints preserved by the routines when running 
alone are also preserveac no matter what mix of them ts run 
concurrently.j Furthermores no individual transactton routine 
sees any of the consistency constraints violated except as it 
temporarily violates them itself during the course of its update. 
Finally» the point of independence of concurrent transactions 
between the two phases provides a handle on the probles of 
reproducibility, because a serial schedule can be created which 
will reproduce the results of the concurrent) updates for every 
transaction. “a 


The Kiar Bwaee requirement 15s not strong enoughs however» in the 
case that it is noticed that a certain transaction causes an. 
abort recovery every time it is submitted (due» perhaps» to a 


programming error). In this case» tc make any progress» the 
transaction in error aust be erased from the global transaction 
history file and not resubmitted. If some of the results of the 


transactions have been displayed on terminals» then there. are two 
alternatives to insure that the results of the rerun are the same 


as what has already been displayed. The first is to not unlock 
any records in the transaction, but to tet ENDTRANSACTION do it 
instead. This insures that no transaction can depend upon 


another transaction's changes until the other transaction has 
executed ENDTRANSACTICN» and will nots therefore» be erased from 


the transaction history file for causing an abort recovery. The 
other alternative is to execute ENOTRANSACTION SYNC to protect 
agatnst aborts» but this wilt probably cause unacceptable 


throughput degradation due to excessive synchronization overhead. 


The two phase technique must be modified somewhat when a large 
number of records must be retrieved during a transactions because 
CMSII does not provide a convenient way for a program to keep a 
large number of records tocked. Programmatic conventions must be 
defined such that in order to access a certain class of records» 
a specified record must first be locked. This technique single 
threads access to the defined class of records. The records in 
such a ctass are exewpt from the two phase requirements byt the 
control record is not. An example of this technique its for the 


user to create special control records which are used onty for — 
locking purposes. : 
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DATA BASE 


Syntax: <data base> 


> Oe neem nme new ema nem enon 
j bed | | | { 
[htt enn enn wenn ne nen en enn een n nen ene- meme nen nnn -n =| 
I | | | | 
Pm"/1Ne° OPTIONS w--- CK<option List>) were e- 5 ment 
' | _ | | 

Pmm/1INmT" PARAMETERS -- (<parameter tist>) -* 3 <=>] 


| Kee remem emma ene , Pr eae ee ep ee 

1 | 4 
DP ational 1 Gadel <audit tratl> on oe oP a am ne me ee oe oe an , aa ema = > > 

ya er’: | : _— a : 

i | | i 
I--~- <set or subset> ererrnsarennne ieee as | 
foo | ' 
[--- <physical attribute spec> --"-+---==->] 
i | es i 
jro- <remap> can anne wan enema ten mama awen saa) | 
i | oe 4 
I--- <lLogical data base> ----teencennen->] 


> > re eee eee enn meme enn ew wen een ewe ee ewe ewan en nee= wa-=># 
i | . | | { 
| Kn en een ee een een enn nn nnn one cen en enn| 
| | 
I--- <generate statement> c-- 3 ss" --=>] 
j : | | l 
[--- <purge statement> “"" 5 seswrerrese=>] 
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DATA BASE OPTIONS 


Syntax: <option list> 


I <n en nee nnn nee ---- pom atom erent rene ene nnn] 

| | | 
pemen/iNtem AUDIT coments cm enter eter cnn c ene n en newer tenn nnmenna>y 

a | be } 

b--/1\-"- KEYCOMPARE c2->1 Lon-- SET --99>1 

! 

Pern RESET ==>! 


Semantics: 


Options are used. to detoeeans the inclusion of. a a features: o f 
the DMSII procedures: 


A. The AUDIT option allows auditing of the data _ base. When 
3 this option ts used» the data base must include exactly one 
restart data set» described Later. If set» the OMSII 


procedures will maintain an audit trail of changes to the 
data base so that data base integrity can be restored in the 
case of processing failures or storage failures. If neither 
SET nor RESET is specified» SET is assumed. : 


Be The KEYCOMPARE option allows the system to verify the key of 
a retrieved data record against the key of retrieval. If 
neither SET nor RESET is specified» SET is assumed. 
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DATA BASE PARAMETERS 


Syntax: <parameter list> 


i< =— mo me we sa nen near ae an eee ome 


pemmmn/1\== CONTROLPOINT <= = == <int> seenn een e nn nne ne ---- oot 


i | i | ist 
i | ? f- SYNCPOINTS =>! 1 
( | : | i 

{ 


l--/1\-- SYNCPOINT -- = o- <int> --------- ter ter renee --> 
| {- TRANSACTIONS ~>t_ 


Semantics: 


The <parameter tlist> is used to provide certain run-time 
parameters to DMSII: 3 7 | 


As  CONTROLPOINT specifies how many syncpoints should cccur 
“between  controlpoints. | Default 1s if syncpoints. 
CONTROLPOINT applies only to audited data bases. 7 


Be SYNCPOINT specifies how many transactions should occur 
between syncpoints. Default is 5 transactions.  SYNCPOINT 
applies onty to audited data bases. | oe | | 


COMMENT 


Syntax: <comment> 


[ <mw wwe were wa teen n <n on on on me 
{ | q 
1. | 4 | | 
>waanaan FF eceonwne/] 1 2\7" <€chaeracter> == ce ee ee eee ee ee ee >t 


Semantics: 


The quoted comment (limit = 172 characters) provides a facility 
for including descriptive information in the data base — 
description tables. | | : 
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AUDIT 


Syntax: <audit trail» 


> meme ae AUUIT TRA It Mena annananan name sialaietateiatatatetatatatatettate ee ee ee >> 
| | Caw enn we nw wenn nanan ? Wea amcet tesa ene a nanan mes | | 
1 | to 
( ee - i 
>>eC ReA/1Ne= AREAS -e-- == = -9= <int> ---------- wn an---- y-=>4 


a -_ 4 
ESS INT PM AREALENGTH == = == <int> <== BLOCKS --->1 
on | | ’ ; 
Im/1N-= BLOCKSIZE --- = <== <int> -=- BYTES -=-->4 
| | : 


P-/1Ne" FAMILYNAME == = === <familyname> ------- >t 
{ | { 
f-/1Ne-" KIND e722 -- = swwen CISK ones er ences “==> | 
! | I~ TAPE ce-=>] | 1 
Z| | I~ TAPE?7 --->1 | 1 
' I- TAPE w-->], ! 
! d- TAPEPE -->1 i. 
\ | | i | | ! 
b-/1\-° SECURITYTYPE <= = "=" PUBLIC cone wnnnnn> | 
j - | I-- PRIVATE <-->] { 
i | - 7 7 
P-/1Ne7" SECURITYUSE ---* = ---= 1Q ser esr ew eaan ~o=>] 


dee IN -2->1 
| I-- OUT -->1 
Semantics: 
Defaults for audit trail Attributes: 
A. AREAS is 20. 
B. AREALENGTH is 106 blocks 
c. BLOCKSIZE is 1800 bytes. 
C0. KIND is DISK. 
Ee FANILYNAME is SYSTEM DISK 
Fe. The attribute SECURITYTYPE specifies whoe apart from the 


OWNET » may access this file. The mnewonics of the 
SECURITYTYPE attributes are as follows: | 
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PRIVATE: Implies that only a privileged user or the cwner 


may access the file. 
PUBLIC: Allows access to any user who references the file. 


The default vatue for SECURITYTYPE is PUBLIC if the 
multitile-id of the file does not contain a usercode. 


Otherwise» the security attribute of the usercode is used. i 
This attribute is anreueeu le only if kind= DISK» and access | 


is not through CMSII. | | | 7 : | 1 


Ge The attribute SECURITYUSE specifies the manner in which a 
disk file that is protected by security may be accessed. 
The default value for SECURITYUSE is I0. The mnemonics of 
the SECURITYUSE attribute are as follows: | | 


IN: Indicates that read-onty access 1s allowed to the file. 


OUT: Indicates that write-only access is allowed to the | 


Ig: Indicates that read/write access is allowed to the 
file. —— : | 


This attribute is Spokicahi ent y if kind=DISK» and access | 7 
7s not through CMSII. | 


foe 


ed 
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QATA SETS 


Syntax: <data set 


>Pm= <data Set> stern mmr eee nee te nr w en meee enn e nnn CATA SET ~->> 
name> : a i 
_ t-- <comment> -->1 I- CRDERED --~>1 
| 7 ae RESTART “<-->! 
I- STANDARD =->1- 
I- UNORDERED >I 


>> <record description> Renan ananeannes Bannan a =m =m wna nwanawanaaoawee > ff 
' | | | 4 
f---- » == <physical opticn> -->1 


Semantics: 


A <data set> description provides for specification of both the 


physicat and togicatl structure of a file. The different data set 


structures are: 
Kc -CROERED 


This structure requires exactly one <access> to define the 
key. Records in each table of an ordered data set are kept 
in physical order based on thei key» § Tables are Linked 
together Calso preserving the key order). Alf records in a 
table belong to the séme master. Only the one access method 
7s)06permitted. No sets may be associated with such a data 
set. This structure must te embedded. , 


8. RESTART 


The RESTART data set is a special type of STANDARD data set 
used for audit and recovery. Exactly one data set with its 
description must be designated as the RESTART data set if 
the AUDIT option is specified. This structure may not be an 
embedded data set» and may have NG. embedded structures. 
within ite 7 | 


C. STANDARD 


Records will be placed in a system selected location. This | 


structure may not be embedded. 
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De UNORDERED 
Records will be placed in a system setected location. © 
Physical tables are maintained in a Linked list. This. 
structure must be eabedded. Alt records tn a table belong 
to the same owner. Ne sets or accesses may be associated 


with such a data set. 


‘The default data set structure is STANDARD. 


DAIA SEI RECORD 


Syntax: <record descripticn> 


> 2m am a oletetateta ta tedetetatetatetatetetatetatehabetaietetatekatete ea aes ee <i seh sa: la” i as om mm mm ma ee >> 
i | a | ! 
Pens1Ner= REQUIRED ALL sees eenten en n-n- wonneeene > 
[<enmemnnnm 5 eee 


>>o- oie <data Ped we cece ewe mewn newsmen waneace ) uae = >> 


| an | 1 
j-- <group. item> san awe a)> | j--- ; amm)> | 
t: - | | ( 
be"/i\-"<control item> ~->1 
! , | i 
i | { 


i-- <set or subset> ccc >4{ 
; +e 
As <remap> ee et ee. ee >I 
DE en Nae a ee ae ae a te ee Oe re ow ee mee eee meme emer nw >> 


i | | | 7 5 a 
(Smeseseseeesessror= VERTEY “= C<condit 1on>). <-> 
J i | | 


> > ewe een mae amen meme enw oan onan ewes Se ee ee ee ee ae ee ee 


j | z | | j 
Isere- <vartable format part> ----7>!I 


ed 
a 


Ci 
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semantics: 


A <record description> specifies the format of a record of. the 
Gata set. | 


The physical records of the Structure associateg with the data 
Set are referred to as members of that data set. OO 


REQUIRED ALL is equivalent to specifying REQUIRED on each <data 
ttem> of the data record. | ? 


The VERIFY clause Specifies a condition to be satisfied by items 
in the potential record of a data set. If the condition is not 


satisfied» then the record will not be storeds and an exception. 


Data iter 


Syntax: <data item> 


2am <data item e-ennn-nnmnn eee eyot a CYPE> aww mswmm mmm nn nnn y 
name> i i | | 7 
i= <comment> =->4 | (Ur <item s--em->, 
| 7 option> 


Semantics: 


A <data item> is a field in a record whose value is controtted by 
application brograms subject to the restrictions placed on data 
values by the <iteg option> clause and the VERIFY clause. 


Data Iype 


Syntax: <data type> 


> eee ALPHA nm = a: om ( were emcee <integer> _— me wm Jre mam nnmenn> # 
{ | | { 


{ { 
1 7 I<-- 5 mens inn] ‘ 
1 | i | t 4 
bo | i a an | | 
I NUMBER == ( se---------- <integer> ------.-- ) mea nnnmn>y 
7 | ! i 

I-- S =>] 
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Semantics? | 


ALPHA items are stored as EBCDIC characters. The NULL value is 
alt bits on. The maximum size of an ALPHA item is 8191 
characters. NUMBER items are stored as 4bit digits (Ci.e.» 
packed decimal) with a maximum size.including sign digit of 23 
digits (12 if used as a key item). The null value is att tits. 
OMne , | 


NUMBER declarations are treated as folltous: 
X NUMBER (55-2) 


"xX" cccupies one digit for the sign followed by five digits for 
the number and the decigal goint ts after the third digit. 


[tem Option . 


Syntax: <item option> 


peeeieae OCCURS ---- <integer> ---- TIMES ----- iniubinies 
eee REQUIRED in hig ie eeaeninsenipis hirano annliics 
ingles INETIALVALUE =---"--------- <Literal> pani 
[-= 1S => dee BLANKS >t 


Semantics: 


REQUIRED items must be present and not NULL at store~time. The 
REQUIRED ALL option for a data set will make all items REQUIRED. 


 INITIALVALUE specifies a means of setting item values at the time 
of creation of a record. Iteas with INITALVALUE specified wiltl 
be initialized to that vatue on CREATE. If the size of the 
literal is less than. that of the item» the literat witl be stored 
into the ttem tn accordance with COBOL conventions. If the size 
of the Literal is targer than that of the item, then an error 
wilt be given by DASOL. Items with no INITIALVALUE specified 
will be initialized to null Catl ones). | | : 


OCCURS causes the item to be repeated the specified number of 
times. The Limit for the <integer> is 1025. | 
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Group Itea 


Syntax: <group item> 


| > == <group jtem name> Sea seice aaa nese ses GROUP waanmaeaaey)y | 
i- <comment> ~->1 


> > ee nn ea nn nn en rn mee nee nnn en en tenn nanan >> 
i — | a | 
| Coe memwewmnnw newest ene 4 cnr ee een en meen nena =| 
i | b 
Pere siNer= OCCURS “= <integer> --- TIVES =-->1 
( | a 7 
PASe 71 Ness" REQUIRED, Sheree enter or sess renee ers 


J <- cee won , — 2 wm am an ew 


i i 
i i ; 
>> ( 22" <data item> score ese ewww eens ) cece eeecee o--->f 
i , { ' { 
i-- <group item> <-->! Pas 3. SSI 


Semantics: 


<group item>s are alpha items that themselves contain items. 
Items within a group are declared at a level one greater than the 
Level of the group. | | 


Items that may belong to groups are restricted to data items and 
further group items. <group item>s may be REQUIRED or may occur 
a specific number of times. If a <group item> is REQUIRED.» each 
item in the group is required. group is required. a 
An OCCURS group may contain further OCCURS <group item>s or 
CCCURS <data item>s. However » a maximum of three tevets of 
OCCURS is allowed. The Limit for the <integer> is 1023. 
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‘Control Ites 

Syntax: <control item> 

>= <control wane nnn nena nn cnn nnenee RECORD TYPE -- <data wert >> 


item name> | Of | type> 
| i-- <coament> -->|] 


eee een ear ager ey Se eee Ee eae eee eee ey ee ee ee ee ee ee eae eee ee eee 
| | | | . ef 
“Pon= FLXEOFORMATIVALUE ““<f- 823 e="'=<- <literal> --->1 

7 i | if 4 

Pe~ TS -e>t t-- BLANKS =>! 


Semantics: 


A <control item> is maintatned in the record itn which tt is 
described and it has specific system meaning. 


RECORD TYPE is required for variable format records. Its vatue 
determines which format a particular record hase Fach data set 
has a maxinum of one RECORD TYPE controt item. The 


FIXEOFORMATVALUE clause specifies the value that the RECORD TYPE. 
field witl have when the record consists of the fixed portion 
only. If a FIXEDFORMATVALUE is not specified and the data type 
of the RECORD TYPE is ALPHA» a value of BLANKS ts assumed. if 
the data type is NUMBER» then. a value of zero is assumede RECORD. 
TYPE 1s a read onty field. An attempt to modify this field wilt 

result in a data error. : | | 
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Variable Eormat Part 
Syntax: <var iable format part> 


CS KOO DOR ABABA ARASH ATO TAS ese eee EET TS comm me | 


i | a | ft 

i | . 4 [<2r- 5 enn] a 4 

i | | ; 4 A 8 { 

>>wemencee <literal> == 3: 27 (€ #* <data ster esse rr= ) mre 

{ | ! wtem> a | ot l 1 

i- » =>) : { ee on | iol 

oo i- <group => t- 3 =>1 1 ot 

jtem> | i 

i st 

[Crem nme emer amen nenmannaannasas meecceemmnnt | 

to. 3 | 

preerererwrn= VERIFY == € == <condition> -- ) =>! 

i a { | 3 


Semantics: 


A RECORD TYPE control item must be declared in the fixed part of 


the record. The titeral specified in the <variabte format part>. 


description must be of the same type as the RECORD TYPE control 
item. Each titerat must be unique. | | 


Each different fornat is constructed bye eakang the fixed portion 
of the record and appending the appropriate variable portion. 
The variable portion is selected by comparing the RECORD TYPE 
item with its possible values as specified by the titeral fields 
in the <variable format part> specification. if the RECORD TYPE 


item ts equal to the FIXEDFORMATVALUE » the record consists solely 
of the fixed DORR AO He | 


CONDITION 


Syntax: <condition> 


> soe <sinple condition> ce ew ese mena ee EE Ne a Se ee ee =-># 
| | { 
l-- AND -""" <condititon> ---7>1 
j a 


be- CR =>] 


aA SAU a aa pal i A nia IT hy + 


rae. 
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Syntax: <sieple condition> 
Pe meenncwmmomnn ( == <CONdItiCN> 77 ) mettre sete sen em eect enen ft 
: io | 4 
I- NOT =>! 1 be | | | er { 
7 | i-- <data item ~-- <relation> --- <data item -~->1 


name>... | 1 name> 1 
i | ( 
i- <literal> e--7>1 


Syntax: <relation> 


pam wm mmm mnwemwnessenen CEGL sort tsssseserserernn- an anal e women -># 


Semantics: 
In any siaple condition of the. form: 
“=~ <dataename.i> ~"- <relation> --- <dataename.2> -~> 


the data itens. 1 and 2 must be of simitar type (Ce.ge» 
ALPHA~ALPHA» NUMBER“NUMBER). | 


In any simple condition of the form: 
“w= <datasename> c--"= <retation> --- <literal> e-----> 
the data item and the Literal must be of similar type» except in 


the case of a hex literal which is essentially of type alpha. 
The legal combinations are: | | . _ | Pe 
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@e ALPHA - alpha Literal or hex Literal 
be GROUP - alpha literal er hex literal 
ce. NUMBER ~ numeric literal 


In cases of alphanumeric compares where <data.name.1> and 
<data.name.2> or <literal> are oaf different tength» the 


comparison is made after extending the shorter string according 
to CC8CL rules. : 


Where <data.sename.l> or <dataename.2> is defined within the scope 
of an OCCURS clause» all necessary subscriots must te specified. 


Precedence of operators from highest to lowest» is: 


NOT 
AND 
Ok 


Evaluation is from left te right with due respect for 
parentheses. : | | 


ae | 
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SEIS AND ACCESSES 
Syntax: <set or subset> 


>= <identifier> ale doaiat tated ketakaketettetekatatotetekataketeteketdtetatekatateteteaded ? ‘ 
to : 
I~ <comment> ~~->1 


> pw amen eceranaaaneaa <gset> a ne errr 
1 | 1 iol ; ae 
{ j-=- <subset> --t t=" »s<physical option> ==>! 1! 
i | | ! 


J wee en wwe een <accea@ss> an noma naam mannan nanan wana na =» | 
Semantics: 


A <set or subset> description provides tlogicat and physical 
specifications of an access method which wilt tbe used in storage 
and retrieval of data. 


A <set> inctudes one reference for each and every record in the 
associated data set. | | 


A <subset> includes» in general» references to only some of the 
records in the associated cata set. oo | | 


An <access> functions similarly to a set» but may ce applied onty 
to ORDERED data sets. Exactiy one <access> must be dectared for 
each such data set. No physical tables are associated with 
<access>Se | 


SEIS AND SUBSETS 


Syntax: <set> 
—  >eee= SET OF co" <data set name> --- <key structure> oletatehetetetieta.s 
Syntax: <subset> 


>es SUBSET OF =~ <data set serettenrtenrrnn- <key structure> --->8 


name> t { 
j . Lies So Ses ese e ee emer | 
f _ & | 7 | | . #4 


l-- WHERE “= (=<condition>-) “=>! 
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Semantics: 


<set> may only reference data sets declared at the same level. 
The set and data set must both be disjoint. | 


A <subset> which specifies a WHERE <condition> is catited an 
automatic subset. A <subset> which does not specify a w?WHERE 
<condition> 1s calted a manuat = subset. An automatic subset 
includes one reference for each record in the associated data set 
which satisfies the <condition>. A manual subset irctudes only 
those references explicitly inserted by application programs. 
Automatic subsets may onty reference data sets at the same level. 
Automatic subsets must be disjoint. | | 


A manual subset may reference any Standard data set which is 
disjoint. A manual subset must te embeaded. | eas | 


Key structure 


Syntax? <key structure> 


{ : i 
J < ame wwe ems as wan meee ee » “se namam ama ae ao | { 
a _ 1 oo4 
tee-/i\7- DUPLICATES annem wena em wa mae am mm > f 


t j 4 | i i 
{ t- NO DUPLICATES ==>! , i : 
| | { 
Pmnws/iNe7 re INDEX RANDOM eeeererernsee | 

1 | | { 

I- INDEX SEQUENTIAL wt 3747" >° >1 


1- ORDERED LIST --2r-ne nnn nnn 


| 
{ 
{ 
i 
{ 
{ ' te 
1 
‘ 
i 
; 
f | 1 | 
f-~ UNORDERED LIST cot 


Yai 
ei 
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Semantics: 

A <key structure> defines the organization of a set or subset. 
It may include a key on which records may be retrieved. In. 
additions it may specify the table structures (e.ge» INDEX 
SEQUENTIAL). © oe. | | 
The access techniques available are: 


A. ORDERED LIST 


An ordered list is a callection of tables. Entries within 
the table are ordered on key. | | 


Each table entry consists of a key and an address. 
Tables are Linked together. 


This structure may only be used for manual subsets with a 
<key>. 7 - | 


8. INDEX SEQUENTIAL 


Coarse table entries point to fine tables or other coarse 
tables. §$ Fine table entries point to data records in the 


associated data set. 

Entries within both tables are in sequence on key. 

When a table becomes full» the table is split. into two 
tables» based on the SPLITFACTOR. Refer to <physical 
option> under Phystcal Attribute specification. 


Table entries consist of a key and an address. 


This structure may only be used for automatic subsets and 
~—6setse. | | 


Ce. INDEX RANDOM 


MODULUS represents the number of tCasic tables in the set. 
Refer to <physical option> under Physicat Attribute 
Specification. | | | 


A hashing algorithm ts applied to the symbolic key to obtain 

a basic table numder in which to tocate the tabte entry. 

The table entry consists cf the key and address of the data 

record. If the selected basic table is full» an overflow 
table will be used. | | 
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This structure may only be used for sets. 

D- UNORDERED LIST 
An unordered tist is a collection of tables. 
Table entries consist of addresses only. 
The tables. are linked together. 
This structure aay onty be used on manual subsets without a 
<key>. If onty one entry has been inserted into the manual 


subset» then that entry is carried in the parent record (no 
list tables are allocated). | | 7 


The ordering of duplicate key records is unspecified. 


Default organization for sets with keys 1s INDEX=SEQUENTIAL for 
disjoint sets or automatic subsets» and ORDERED LIST for manual 


subsets with keys. $$$ Default organization for manuat subsets 
without keys ts UNORDERED LIST. 


NO DUPLICATES is the default for atl sets or subsets with keys 
DUPLICATES must be specified en any automatic subset with keys. 


Key 


Syntax: <key> 


>" KEY S228" e cer eceese“=we= <key name> ee 2S aie ~~ >H 
t-- [S§ ==>! § | im- ASCENDING ~~ >1 
| i | i { 
Cera wae | {=~ DESCENDING ~~>] 


i er | bo 
eae ( == <key name> eet ees ese ene meameaaenm } ==> 
: { om | 
f-- ASCENDING w-->1- 
' eS i 
im DESCENDING “->1 


t 

i ' 

[Kemet rene 5 ratte rene en nnnny] 
i 

! 
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Syntax: <key name> 


HHS SSK ome ee <data JCEM NANe> -H==<=+S sees + sees e-ees5 ># 
: | f 
l--- <group item name> ---~-=->|{ 
i 
I--- <controt ttem name> <--->] 


Semantics: 

Each key name in a key must refer to an item in the data set on 
which the set or subset is declared. the default ordering of 
records is keys ascending. Subscripted items may not te used as 


keys. Numeric data items in a key are restricted to 12 digits in 
length. Key iteas are taplicittly required. 


Index Random sets may not have descending key items. 


ACCESSES 


Syntax: <access> 


>em-= ACCESS TO ==> <data set name> sss ner erence ence enn ->> 


P>RH KChKEY> Te rete ew eww em mewe nee ce ewww eee meen nne => ff 
{ i i BS at i 
“Eee eer],  [erseeren= CUPLICATES ===> 1 

| i | i 

i-- NO =I 


Semantics: 


Ones and ont y one»r <access> must be declared for each OQRCERED 
data set. : | | , | 


Accesses may not te declared for any type of dataset except 
ORDERED. , | | 


NO DUPLICATES is the default for accesses. 


aaa aa 
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PHYSICAL ATIRIGUIE SPECIFICATION 


Syntax: <physical attribute specification> 


a>oee <structure name> ---- ( == <physical option> -- ) --s--<- ->ht 
i | | 1 
Im <data base name> -"-=- ( =- <database physical> <= ) -<=>} 
. opt ton> 


Semantics: 


<physical attribute specification>s are used to specify the. 
physical structure aA the data tase. | | 


They altow the user to place alt physical attributes at the end. 
of his DASDL source input and must refer te structures that have 


been previously defined. 


Any option appearing in a <physicat acer elie ipecreieatruns witt 


override the same option which was specified in the structure 
definition or a preceding <physicat attribute SDC GUS TE QE Ones 


The <physicat attribute speeid seat tens may be declared at the 
disjoint level only» Gut may refer to embedded structures. 


The <data base name> may te that of che payeueat data base or one 
of the logical data bases. 
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Syntax: <physicat option> 


| Cen mena man ewan anannawananmawae ier 


SSS Shit 8 eee oe ese eee Se ee ee 
oa se | | | i 
prema /1Na" AREAS wor cerne = mee <integer> cor nn nner meee neem enn->e 
to 7. | 
1<-/1N-> AREALENGTH “"- = ~*- <integer> --- BLOCKS ------ >I 
‘ | a | _ | ! 
b--/1\-> FAMILYNAME <--> = =<" <familyname> -oo-e+-------- >I 


r | 7 | i 
be-/1N\7- MAXENTRIES ere = co <integer> ws9 ott errr ers senn ol. 
i i 


I--/1\-- SPLITFACTOR “= = -<- <integer> ---2er rrr serene 
riees MODULUS --""2- = --- eee, shenenmeneiehigs 
nga BLOCKSIZE =--- = =-- <integer> --- RECORDS ----- - 
| - ENTRIES “a 
! 7 boo 
i | I- TABLES -->1 1 
ee PAINE. Sram o ss ereacesaenaee sees seaeeas amneae 
athe Said son 2 2s <integer> ------- iene 
eagpon Senceeted wore = c7- <integer> --- ENTRIES eater 
apie 44908 See ere a --- <file name> Sie aen ee ge ane paneer re 
aoe SECURLTYTYPE -* = === PUBLIC ----- wan e------- eer 
Lo - ee I- PRIVATE =->4 | 
iwadnae SECURITYUSE 272 = cee IQ stenetenceceeenen----- > 


f- IN *-->>] 
i- QUT -~>{ 
Syntax: <dat abase physical option> 
poawemem=m SECURITYGUARD “*7 = <2 <file name> ie ee ae ee eran ee 


Semantics: 


The <physical option> provides for specification of the physical 


attributes of a structure. There are four types of physicat 
structures: © standard data set» index sequential access» index 
randoa access» and tist. Note that not all. options are 


applicable to ali structure types. The applicable structures are 
indicated in parentheses. ps 
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A. AREAS 


Be 


This attribute specifies the maximua number of areas in the 

disk file. This attritute may be specified for all types of. 
structures. Its value must be greater than C and less than 
or equal to 105. The default is 29 areas. (SOS» I/Se I/R> 
LIST) | | | 


ARE ALENG TH 


This attribute specifies the maximum number of physical 
blocks to attlocate per area on disks. (SDSe I/S» I/Rk» LIST) 


BLOCKSIZE 


This attribute specifies the blocking factor for the 
structure. The applicable units are denendent on the 
structure types records for standard data setse entries for 


index sequential and index random and tables for tists. 
CSO0S» I/S» I/R» LIST) | | | | 


FAMILYNAME 
This attribute specifies the pack identifier of the file 


containing this structure. The reserved word PACK is 
synonymous with FAMILYNAME. The <familyname> may te 


specified as an tdentifier or as an alpha titeral. This 


attribute is applicable to all structure types. The default 
is the object pack id from the Oneur Statment. (50S» I/5- 


I/R» LIST) 
MAXENTRIES 


This attribute specifies the @aximum number of entries that 
may be enrolled in a set or subsets. (CI/S» I/fie LIST) 


MAXRECORDS 


This attribute specifies the maximum number of records that 
may be enrolled in a cata set. (S0S» LIST) | 


MODULUS 
This attribute srecifies the hash- modulus to be used in 


providing the table number for the start of a search —(1.e.» 
the number of base tables). CI/®) 
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He PRIME 
When used as the attribute of a set» this attribute 
specifies that this set is the primary access method for the | 
data set. The OMSII system uses this characteristic to. 
optimize the file organization of the data base. Only = one 
set may be specified as prime. A prime set must have the 


same number of areas as its data set. CI/R» I/S) 
SPLITFACTOR 

Used for index sequential and index random structures» this 
attribute specifies by percentage the maxinum number of 
table entries to be split into a new table when the table 
size 1S exceeded. The. minimun number is 
C100% ~ SPLITFACTOR). (CI/S» I/F) 


TABLESIZE 


This attribute specifies the number) of entries per table for 
list Structures. (LIST) | 


TITLE 


The TITLE attribute specifies the name of the file on cisk. 


The default for the TITLE IS <default pack>/<data hase 
name>/<structure name>. | e | 


SECURITY TYPE 

See AUDIT (Section 3) Poe deeaiis of this attribute. | 
SECURITYUSE 
See AUDIT (Section 3) for details of this seeribute: 
SECURLTYGUARD | 


The SECURITYGUARD attribute specifies the name of a file on. 


disk to be used to specify the security censtraints on the 


data base. If SECURITYGUARO is not specified for a civen — 
data baseep the access to that data hbase defaults to 


unrestricted. see SECURITYGUARD (Section 7) for a 
description of the format of a Securityguard file. | = 
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DEEAULI VALUES 
Cefault values are computed for each applicable option if no 
explicit value was specifieg vVv1a aes <physicat cption>. I f 
explicit assignment is made» then the DASDL > compiler witt not 
change the assigned vatue. . | 
STANDARD DATA SEI | 

4+ AREALENGTH = MAXRECORES/BLOCKSIZE/AREAS | 


Dw BLOCKSIZE = 1 RECORDS or the maximum number of records 
7 that wilt fit into 1449 bits. 


Ce MAXRECURDS = 10900 
LISI | | 
CUnordered List» Ordered List» Unordered Data set» Ordered Data Set) 


ae AREALENGTH = MAXENTRIES/TASLESIZE « 
PARENT. POPULATICN/BLOCKSIZE/AREAS 


be BLOCKSIZE = 1 TABLES or the maximum number of tables 
| | that wilt fit into 144” bits. 


Ce MAXENTRIES Cor MAXRECORCS) = 10 


d. TABLESIZE = 1 ENTRIES or the maxiwum number of entries | 
| plus the requisite control | information that 
wilt fit into 1446 bits. 
INDEX SEQUENTIAL ACCESS 


as AREALENGTH = 1.4 * inoetes of blocks necessary to represent 
| the population)/ AREAS 


b. SLOCKSIZE = Square ro@t(MAXENTRIES) ENTRIES. 
Ce MAXENTRIES = population of the data set 
de Not PRIME 


e. SPLITFACTOR = 75 
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INDEX RANDOM ACCESS 

@. AREALENGTH = 1.3 * CMODULUS/AREAS) 

be BLOCKSIZE = 1.1 * Square root (MAXENTRIES) ENTRIES 

Ce MAXENTRIES = population of the data set | 

d.- MOOULUS = 1.2 «* ( MAXENTRIES/BLOCK SIZE) ENTRIES 

e- Not PRIME 


f. SPLITFACTOR = 75 


inenenienisitne eetettat iecatemetentecicer oda ee a 


Read Onty (Update or Inquiry) will be allowed. 


T=1 
BURROUGHS CORPORATION | COMPANY CONFIDENTIAL 


COMPUTER SYSTEMS GROUP | | .  -B1E00/B170C CASOL 
SANTA BARBARA PLANT : — PeSe 2219 0433 REV B 
SECURIT YGUARD 


The Security guard file is used to specify to the DMSII system a 


list of users (usercodes) who may access a Given database and 


What type of access is permitted. This file is read by DASDOL 
during the compilation of the data base and. the access 
Information is encoded into the DASDL generated dictionary. For 
this reasone changing the securttyguard file after the DASDL run 


does not affect the data base access criteria. The access _ 
security provided by this gechanisa only restricts access to the. 


data base files via the CMSII system. Access of the data base 
files by any other means is handled by the. regular MCPII fite 
security rules. | : : | . 


Syntax: <contents of securityaquard fite> 


~s2=- wot ean = >> 
oo ! 
Pmwnr= DEFAULT se = were NO tee ernnnnne 5 nnd] 
| | { i | 
cae ese | 
i I 
ioe Rh eee 
oP RR RO MR enn e> if 
i | | | | 7 
[cet ere nse mane en emma nn neem mn nn mmm e mmm nnn nn] | 
t 1 _ | oe 
Jm-m-== USERCODE = <usercode> ---=- NO -<---- ; saa aa 


| ( 
i= RO ==> I 
i ' 
I-~ RW m->1 


Semantics: 


A "xX" at any point in a record denotes that the rest of that 
record 18 a comment. Qnty columns 1-72 of a record are scanned» 
and any other columns are ignored. : | | | 


There are 3 access privileces. NO Specifies that any attempt to 
open the database will be cenied. RO specifies that Read Only 
CInquiry) opens wilt be allowed. RW specifies that Read Write or 


The DEFAULT statement provides the Database Administrator with a 
means of letting OMS know whether or not to approve database 
opens requested by jobs running under a usercode not listed in 


_ the Securityguard file- or by. jots not running under a usercode. 
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If there is no DEFAULT statement, then no access will bea 
permitted except as specified by any subsequent  USERCODE 
statements. This is the same as OEFAULT=NO3. The option 
DEFAULT=RO5) will allow any job running under a usercode that was 
not specified in the Securityé¢uard fite Cor a job not running 
under ae usercode) to open the database Inquiry. Other open 
rights may then be specified in subsequent USERCODE Statements. 


The option DEFAULT=RwA; allows any job to open the database 

Inquiry or Update. The Database Administrator may then list the 
exceptions to this by adding USERCODE statements peauereG access 
le for specific usercoces. . 


Usercode statements are aehe exceptions to the DEFAULT statement. 
A USERCODE statement is used to tell OMS that a certain usercode 
js to have access rights that differ from the access rights 
specified by the DEFAULT statement. It makes no difference if. 
the parentheses are included with the <usercode>. If they are 
omitted» DASOL witl suprly them. - ss 


steae | 
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KEMAPS ANE LOGICAL DATABASES 

REMAP STATEMENT 

Syntaxs. 


>e= <remap name> crates r sense serene REMAPS == <data set -7>> 


i .™ s | name> 
i-- <comment> *->1 | 


>> meee ewe em = om an an am um on sate eal i a em le i -— o.oo a ee ee ee ee ne) 
ie fae - , i 
| <emm mmm neem nme nen fan ieee - 
i — a : | | ! 
beens 1iNeme REQUIRED ALL coer testers ereaene eoo-e mom >| 
! | | 2... : i 
Pan-/1No"" READONLY ALL sees es en esa scene n enn nenne >I 
i Y 4 | { | . | | 
pS {-- NO EXCEPTION -“----=>1 

( ee 

t-- GIVING EXCEPTION -~=-> 


DR ee eae ee ae <remap record descriptton> 2 eae = - — ne oF om a an we > 


Semantics: 


<€remap name> erecnaes the name given to this remap of the <data 
set name>>s which must be previously specified. Application. 
programs may then refer to the <reman name> as if it were a data 
sete ; Sos | 


REQUIRED ALL is suinvatout to specifying REQUIRED for each item 
cof the remap recorde | 


READONLY ALL is equivatent to Specity VAG READONLY for each item 
in a remap record. An exception wilt be returned to the host | 
program tf READONLY fields are modified, unless NO EXCEPTION has. 
been Spee tess | i oe 
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Remap Record Description 


‘Syntax: <remap record description> 


P<ee ere 5 eww ny 
{ | ! | 
>"= € """ <remap item> oem -2nennnnee J swt eeen Se ee ee mm men >> 
| | j { ! ! 
I-- 3 ==> '- <remap record <->} 
optiaon> 


CO ee ee mame e nnn eyy 
ite" <remap variable format part> se=->] . 
semantics: 


The <remap record description> provides a means to specify the 


format of records in the remapped data set. —tems must have 
appeared itn the same part (fixed part or variable part) of the 
original data set. — Any and alt items from the original data set 


May be omitted from the rewap. 


‘288 em ~ab 


Syntax: sremap record option> 


AL NS eee Si eerie eri VERTFY ="= € ==" <condition> --- ) ------ > #t 
4 | | | | — ‘a 
i ite 9. => | | | 4 
| | ~ ee, 
pRat NESTE Mente SELECT Se: (eee <eonda tions <<a. 4. 263) 
i 4 | _ 


= ? ~=>| 
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Semantics: — 


Cnty records satisfying the SELECT condition will be returned to 
host programs . : 7 | : 


For STORE statements» records must meet both the VERIFY condition 
in the remap record descripticn and the VERIFY condition in the 
original data set description in order to be storec in the data 
sete 


Remap Variable Eormat Part 
Syntax: <remap variable format npart> 


| Com meme wwe nme meme mn meme meme 1 
; | | | | : po 
porswosaeeemmnnn= cliteral> -- 2 -- <remao variable format ------>4# 
i 4 description> 3 | | 
f-- 5 m->} | a. 


Semantics: 


Allows specification of the variable format portion of the remap 
data set record. The <titeret> must match a <titerat> in 
variable format specificatien of the ortginal aata set. The 
RECORD TYPE item from the original data set must have been 
remapped in the fixed format portion of the remap record. 


kemap Variable Format Description 


Syntax: <remap variable format description>. 


{ <seer - ? manawa ef 


{ | { | 
>=- ( 7" <remap item> s**t etter eH CY) tt tn te ee ee ew en cn enne > 
| 1 | 1 4 a | | | 
jon @eo4 fr" <remap reccrd =>] 
optian> 


Bok 
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Semantics: | 

Only items apeearing tn appropriate variable formats of the 
original data set may be included in such a dectaration. 


Remap Iten 


Syntax: <remap ttem> 


2a SSS Seer = <Temap CONntrol Viens Seer tees = a ieee mie > E 
' = a a. | 
(Sree ssar ee Geena) Cd ta sets Ser Sen SSS s ee 
1 7 | | ! 
(SSSesereoe= <remap GUCSeCtD Se sae See eers eases Sree ' 

4 | | | i 


AeCseasss> <Penap data iteqe see eses ess asosecses 1 
i | ss 
(Sere rns err: <renal CCOUD> SSS Faqs csss reste reer ret 
’ | a 7 ( 
[SSS er 2Ses= <PeRaAD “FeaGroup.Ing>. “Se seers terete] 


Semantics: 


Items from the original data set are included in the remap data 
set through the use of the remapo item. : ex 


Syntax: <remap control item> 


| > ena <control item ss dss eh ste “i ac es, “sis eh ams Task se ah tak Sw oma om ae we we om Soe se Sse Soc > fg 
4 name> I | 4 oO 4 
{ | i- <comment> -~>f — | 4 


j | = | i 
b-- <remap control tert meet ttt ntereee = ote <control --->1) 
item name> { { item name> 

im <comment> -->1 
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Semantics: 


The <remap controt item> allows control items from the original 
data set to be included ir thea remap. If anew name 15 desired 
for the <remap control item> then the <remap contrect item name> 
option may be used. The <remap controt ttem name> must be unique 
an both the original data set and the remap. A centrol item may 
be remapped onty once in a given remap. RECORD TYPE controt 
ttems must always be remaprfed. 7 


Remap subset 


Syntax: <remap subset? 


peewee <csubset name> wee" ae mecnaee Sale leatatatedidetadar Relate ee 
4 oe i { 
i 7 I-- <comment> -~>} i 
i a | | | : 
i | > I 
f-- <remap subset tw tte ese m meee smn ees = Csubset name> =->1 
name> | -_ ( | 


l=" <comment> =>] — 


LASS SASS ae Se SS Sa SSS SRS = Mee ee aa ea a See Ree a oi 
to | oe | 
i=e2 CF =<=== <data Set name> “er Ssa-ssseeeseeesee >| 
: | | ! 
I~ <reman rame> r- 7-45" pe aa lal 


Semantics: 


The <remap subset> attows the inclusion of manual subsets in a 
regsap. The object data set may be specified optionally. If the 
object is a remap» then it must be a remap of the criainal object. 
data set. Sf anew name is desired for the <remap subset> then 
the <remap subset name> optior may be used. The <remap subset 
name> must meet the uniqueress criteria for structures. 
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kemao Qata 2et 


Syntax: <remap data set> 


>7n-~ <remap NaAMe> wee seen eee pe A eee ey kr ac ia a ae a eae ar 
{ | I-- <comment> ~=->] i 
eg <remap data testers rete cme w omen = om <remap “<-"->{ 


set name> { | i - Name> 


>> Se wma ae newness ame ewe wm we ee ee Ca 8 mm a me me ae we ee mn mm — mm we at em an om mm oe > # 
l | 


Syntax: <set part> 


Pee Creer ALL terre were ww nn nnn amma em we wenn ew nenn) ==>4 
! | 
Pm NONE teeta anon nnn nnn nnn nn nnn mn eww n nn nnn enn] 
i | | t. 
f P< crm enn enna wen , ween wm ewe ne weeny | 


Pm" SETS saewwwe nn wen nn nnn mnenwnnnn= eset of <--->] 


1 , | | 1 subset name> 
{-- <remap set en = ==>] 
name> 


semantics: 


The <remap data set> allows the inclusion of a remap of an 


embedded data set in the remap. The remap of the embedded data 
set must have heen declared in the originat' data set. The <remap 
data set name> option altows renaming of the remap. The <remap 


data set name> must meet the uniqueness criteria for structures. 
A remap may be included orly once in a given remap. oy 


The optional set part atlews inclusicn of atl, mone cr antly 
specified sets and subsets in the remap. The sets may be renamed 
with the <remap set name> option. The name assigned to a set. 
Must meet the uniqueness criteria for Structures. If the set 
part ts omitted» then ALL is assumed. 
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Remap Data Item 


Syntax: <remap data item> 


2S" Kdate J Cee Nale> “S299 2 ss er es Soe ee Se SS Se tee e eS S Ss ere >> 
{ | i : { | i 
i | {-- <comment> -->I ._ 3 | i 
{ | | | i | i 
li-=- <remap data =“ “s3 secs e ores e seme enee= = == €data tten “>I 
ttem name> | | t. | name> 
I-- <comment> 77>] 


i ed - 7 2. - oD anew amonmana > fi 
| | | i 
i--- <remap data item optton> s*--"-~>1] 


Semantics: 


The <remap data item> allows data items from the original data 
set to be included in the remap. If anew name is desired for 
the <remap data item> then the <remap data item name> option may 
be used. The <remap data item name> must be untaue in btoth the 
original data set and the remap. A data item may be remapced 
onty once in a given remap. | | 
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Remap Data Item Qotion 


Syntax: <remap data item option> 


i Slate ielttetatatatate po Rte ene enn e eens 1 
| | of 
Pom ae eee ow JINwe> INT TLALVALUE toe eee meee BLANKS sceeee-># 

{ en ee | i | | it 
I- <data --=>1 1 I 19 *>1 I= <titerat> -1 1 

| type> | _ 4S 
P-/1Ne5- HIDDEN cone een nn nee leat etait tata >{ 

| | bt 

bo 9 READONLY seer enn een e eter nc cnn ee nn-- sot 
} ; | ot 

i i|-- NOQ EXCEPTION --"--+---- >to 

( —— rf 

i b-- GIVING EXCEPTICN ----->1 | 

! : i 

I-/1Ncce REGUIBED concern ----- secant anne some anen>| 

| | 


I-/1N77- CCOCURS -- <integer> <= TIMES -oee-n---- >I 


Semantics: 


The <remap data item option> is for the purpose of respecifying 
the options for the data item teina remapped. Any option which 
is not specified will default to the value of the original item's 


option. 


If <data type> is specif ted» it must match exactly the original 
description Cit is for documertation purposes only). 


If the occurs option is specified, the value of the <integer> 
must te less than or equal to the original declaration. 


The HIDDEN option documents the absence of a field from this - 
remap. The HIDDEN fteld does not exist in the record presented 
to the user>, however» an INITIALVALUE may be specified» and the 
system will initialize the field on a CREATE. HIDDEN items may 


also be used in SELECT and VERIFY conditions. 


The READONLY option specifies that the item may not be Seerewe ey 
the host program. If such a field is alteredr an exception will. 


be returned to the host oragrams > unless NQ EXCEPTION has been 
specified. : oe | 


The INITIALVALUE and REQUIRED options are identicat to the 
options for data sets. <remap data item>s which are REQUIRED in. 


the original data set are always checked for presences regardless 
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of whether REQUIRED is specified or not. The INITIAL VALUE 
specified for a <remap data item> wilt have precedence over. an 
INITIALVALUE for the original <data item>. 


Remap Group — 


Syntax: <remap group> 


>= a & <group name> ~ oo om mm ee eee ee ee ee ee ee RE ae ee se ee Oe a a a eR 


4 | | 
i | a I-- <comment> ->t | 3 | | i 
eS “SEeMap. GlOUp. Settee rr tes Nee ees TS aS COregUp:. ==> 

name > i | | - Name> 


t-~- <comment> <-->] 


PPT A Re eww eee nn meme wwe meme tem teem em wna n> if 
4 ti tf | i 
i-- GROUP -->1 I=" <remap -">1 Ler <remap group c--->1 
| group | description> 
aption> : 


Semantics: 


The <remap group> allows group items from the oriciral data set 
to be included in the remap. If a new name is desired for the 
<remap group> then the <remap group name> optior may te used. 
The <remap group name> must te unique in both the originat data 


set and the remap. A group way be remapped only once in a given. 
remap. : | | : 
If the <remap group descripticn> option is not usedr then alt 


subfields of the group are implicitly remapped. 
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Remap Group Qptiaon 
Syntax <remap group opticn> 


ae ee esa se ye ee Ps Se mw em mem mene | 


Poewamowmmammm /]\erern= REGCUIRED =-------- alates came tame ee >a 
oaeiiensns CCCURS <integer> aby salesmen 
7 a peseesee er aren anne 
Bs READONLY aSHSSeRHGS case wane-------- /; 
si NC EXCEPTION <--+-->1 


| a 
I-- GIVING EXCEPTION -~>1 


Semantics: 


The <remap group option> 1s for the purrcose of respecifying the 


options for the group being remapped. Any option which is not 


specified witt default to the value of the original group's 
option. | | | 7 


If the OCCURS option 1s srecified» the value of the <integer>. 
must be less than or equal to the oricinat declaration. 


The HIDDEN. option documents the absence of a qrouc ttem and alt 
Its sub items from this remap. The HIDDEN group item is not in 


the record presented to the user. HIDDEN items may ke used in 
sae eas VERTFY conditions. , 


The KEADONLY option specifies. that the group item and all its sub 
items may not be altered by the host program. If such fields are 
altered» an exception will be returned to the host program» 
unless NO EXCEPTION has been specified. : | 


The REQUIRED option is identical to the option for grouo items. — 
items which are REQUIRED in the original data set are always 


checkea for presence. 


Fapensie ah ng «shoe's shu n> tab Ba ts tution wd ay Reagcbaarl hana’ begins? oa oat wobralets Me po daar Ta wea 1 Bey tee i me Slo ogee 
. Be a a 

ni 
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Regap Group Description 


Syntax: <remap group description> 


PKrecr enn fF cee wre rennnn| 
| i | { a | 
>pe- ( s-- <remap data item> cert ee ee a ees hee 2a ee >t 
i | a i of 7 i 
l- <remap group> sett t7>b bat Fmd 
1 j 


im <remap regrouping> ~-->1 


Semantics: 


The <remap  qroup descripticn> attows for the redescription of 


ite@s within a group. Gnty items which are declared in the 
original group may be remapped in the <remap group description>. 
Alt items must he respectfied such that their number o f 


subscripts does not change and the sizes of alt subscripts do not 
exceed the original declared sizes. 


If the <remap group descriptian> is omitted» ait items in the 
original group wiltt be remapped without change of name or 


options. 


Remap Regrouping 
Syntax: <remap regrouping> 
>ewe= <remap regrouping nare> ceoe= GROUP lela eteanates wennnn->> 


Fe et eee nae ee ogame poe er ep ee ee ee ee ee ee m7 me 88 om ww me 8 ee ee 7 ae we a OD Om Om aD an ae om a me am >f# 
| 7 | 
eee sere Sen eS eS <remrap group option> Seve er een 


| <oennnn---- poset ne nn nn---- 
t | | _ 
aa ¢ Soo <remap data item> a ae ee eS ee ee ee =o mo ) oanman > # 


I a 
i-- <remap reqrouping> ---->1 


— | _ hai? 


BURROUGHS CORPORATION | | COMPANY CONFIDENTIAL 


COMPUTER SYSTEMS GROUP | | BLenNnsBi7A% CASOL 


SANTA BARBARA PLANT | 3 | PeSe 2219 0433 SEV BR 
Semantics: 


The <remap regrouping> allows for restructuring of the data tn 
the remap. The <remap regrouping name> must Ce unique in both 
the original data set aie the remape | | 


The CCCURS option must be specified in the <remap group option> 
such that all ttems remapped in the <remap regrouping> have the 
same number of subscripts as the items in the original data set 
and the sizes of all subscripts do not exceed the original 
declared sizes. : 7 . 


LOGICAL DATABASE 


Syntax: <logica!l database> 


>-=- <logical database hanes SSeS se eS SSS a - CATABASE =o 
{ | i 
i-- <comment> ->1 


>> ewan Po ee ee ee ae eee SE OO ee, ee eae ee ee 242 ea > a 


Tss> SECURITYGUARD = <filename> --->] 


Semantics: 


The <logical database name> specifies the name of a togicat 
database. <togical database%s control which database structures 
can be accessed and how these structures can be usede WwWhen 
<logical database>s are deelared in DASDL» the <data sets, 
<cremap>se»e <set>s» <subsetos ard <access>es which are to he 
included in each <togical database> are listed. Host language 
programs @ay invoke Structures selectively from a <togical. 
database>. Programs can only use the structures ccntained in the 
€togical database> they tnvoke» thus the database dui peeairecead 
may controt which structures are accessed by eoet rain whic 
<logical database> is used. 7 | 


A SECURITYGUARD file may be assigned to each clogicat _database>. 
The Securityguard file specifies who may open the <logicat 


database> and how they may access it. The Securityguard file is 
read by OASOL when the database is compiled and the access 
restricttons are recorded in the dictionary. See SECURTTYGUARD 


(Section 7) for a description of the fornat of a Securitycuard 
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Structure List 
Syntax: <structure List> 


Di ree eee ee fe ae a ete » ee ee ee ee o=~ | 


SSH See Hee ae ese Se sec= <dataset: nake> <“Sss9s=s6See ss ses'ss= >2 
i | 4 1 | SS a 
f-- <structure = -->1 f-- <remap name> <--> le-- <set --r-->!] 

name> - | part> 


Semantics: 


The <structure list> specifies which <data set>s> <remapnrss 
<sgetrses <subset>s and <access>es are to he included tn the 
<logical database>. | 


The <structure name> option changes the name of a <data set> or 
<reMmap>e When the <logical database> is tnvoked and listed tn a 
user program» the new name replaces the original name. All user 
programs which invoke the <togicat database> refer to the 
structure using the new name. — | 3 


ALL <data set>s and <remap>s named in the <structure list> must 


be disjoint. If a <data set name> is specified» all of its 
embedded <data set>s are automatically included tn the <tegicat 
database>» and embedded <regap>s are excluded. when a <remap 


name> is specified» the embedded structures named in the <remap> 
are included in the <logtical database>. oo 
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set Part 


Syntax: <set part> 


Pe CTP ALL terre rene wenn nnn enn --- 2 ---------- srt er eee n- ) =>y 

tae _ | ' 

1S NONE enn-2----- 2-5 --- eee ee ~=-=>| 

7 —— 4 
re ee ee er ya 

i - a ee | 

PS. SEES Saree Seat Sen es ee ees <set or cr------>| 

| 7 Oo | { subset. nate> 
im" <set name -- = =>] 
name~2> 


Semantics: 


The <set part> specifies which disjoint <set>sp <subset>s and 


<access>es are included in the <logical database>. If the <sat 
Part> ts not present, or if ALL is stipulated» alt disjoint 
<set>s»p <subset>s» and <access>es are included. If <setos> 


<gsubset>s or <access>es are specified» they must refer to <data 
set>s or <remap>s which are inctuded in the <legicat database>.. 
The <set.name.2> option can tbe used to change the name of z 
<set>» <subset> or <access> in the <lLogical database>. 


gi vesicle 


Gay 


BURROUGHS CORPORATION - yas COMPANY CONFIDENTIAL 
COMPUTER SYSTEMS GROUP. | 81800781700 DASDL 
SANTA BARBARA PLANT PLS. 2219 9433 REV B 


REORGANIZATION STATEMENTS 


The reorganization statements are part o f the generat 
reorganization capability of the DMSII system. For more details 
see the 81800/81706 OMSII Reorganization document» P.S. 2219. 
549. | 


GENERATE STATEMENT 


Syntax: 
>" GENERATE --- <set or subset name> c---nn- nnn een n ene n nn nn ne-y> 
Bee oA : = 7 | i 
I- <data set creer nn nnn enn------ cena een mane tae 
name> f | { 
f= OQRDEREC BY -- <set s---->] 
: | name> 
PPTL RL A KK RR OMe ee — wo ow a oo ===>: 2 
i j | 


Im-~ (=> FAMILYNAME -- = <familyname> -=) -=>4 
Semantics: | 


The GENERATE statement causes the system to garbage collect the 
Structure specified. The GENERATE statement may only be used if 
the SREORGANIZE option is set. | | | | 


Semantics: 


The PURGE statement causes the system to remove all elements from a 
structure. The PURGE statement may only be used if the SREORGANIZE 
option is set. - i Se | 
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2 OPTIONS 


The foitlowing describes the general syntax of the DASOL Compiter 


Control Gptions. 


ee ee meme ew a —_ ea me we a oe eo ee a em ee mm on mm we on me oe am we on ae an me a on om om > # 


i 
S$--1 | [<acenns 5 en--- ! 
| en i { l 
[<r t we meee mene wom om ew 8 ee em me me eo ee on em } 
{ | 7 { 
(eS <DASDL one-time option> ------------=>,; 
) | oo | 
I----- <DASDL option> --------------- won ---->] 
mw" <DASDOL option value> ---------------- >| 
i | | 
|----- SET sencn------ wenn nena nn ------ ~--=>! 
f { | 
[----- RESET =-=>1 
j i 
Jorn es NG comma» | 


GENERAL SEMANTICS 


which is Limited to that of the current compile. 


Every DASOL compiler contrel option card image must have a 

Cotumns 73°80 may be 
image is interpreted 
with the first character 


The card 
beginning 


Any DASDL option card image beginning with two consecutive 
characters ($$) denotes a permanent 

which will be included in any new 
A single dottar > 
the life of 


1. 
dcllar sign ($) character in column 1. 
used aS a sequence field. 
from teft to right 
following the dotlar sign character(s). 
26 
adjacent dollar sign 
DASDL option card imacer 
source file generated via the "“NEW™ option. 
sign (%$) character denotes a temporary opotions 


DASDL one-time opions may be SET or RESET anly oncer and 
such setting or resetting gust occur before any DASDL source 
images are processed. AUL other DASCL compiter controt 
options may he SET of RESET any number of times and anywhere 
within the DASOL source file. | 7 
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4. If a DASDL compiler control option appears without an 
explicit "SET"» "RESET"» or "NO"» it is implicitly enabled. 
5. Parameters may or may not be required for any particular 
option. — see the explanation for the item invotved to. 


determine the Seuss aay, of Pat awel erst: 


NOTE: Any option requiring parameters must be the last 
option to appear on a DASOL compiler control card imace. 


DASOL ONE-TIME OPTIONS 


Parameters are not allowec unless Otherwise specified. Default 
setting 15 disabled for all options unless noted otherwise. 


CONVERT | This option specifies that the internal format of 
an existing data base dictionary must be modified 
to reflect the format required by the current 
Level of the MCP. ALL dictionaries created 
previous to 8.9% must pe converted to the 2&8.” 
dictionary format in order to run on an &.9 MCP. 
As conversicn is a self-contained process» no 
other input is accepted. Any DASDL source images 
following this card will be ignored. | 


FILE | See STRUCTURE. 
INITIALIZE When preceeded by "NO" or “"RESET™+ this option 
| | inhibits file Initialization fcltowing DASOL 


source encoding. This ootion ts intended for 
development use cnty.. | 


MERGE This ootione when enabled» causes the OASDL 
3 | compiler to merge source images frog the. primary. 
input file C™CARDS"™) together with source images 

from the secondary pot file C™ SOURCE™). 


NEW | When “set™, this option enables creation of a new 
source file (C™NEWSOURCE™) containing all source 
images and permanent ODASDL compiler control 


options processed froma the primary and secondary 
input. files. : 


a RRS ela SE eR A aC a eee ate i ie eT gone eee ORE ee: Sa ei henselae 
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RE CRGANIZE This option enables reorganization of an existing 


SOURCE 


SOURCEQNLY | 


STRUCTURE 


TABLESIZE <max 


TAPE 


data tase. For more detaitss see the B1600/B81706 


DMSTI REORGANIZATION documents» P.S. 2219 N54n, 


This option enables the printing of the COBOL 
library fites generated by OCASOL in the output 
listing for this compile. | | 


When enabled, this option causes  DASOL to 


regenerate CORDL and RPG tibrary fites for an 
existing data base without recreating the data 
base. No cther functions are performed when this 
option is specifieds and ro other source images 
will be processed. | = 


TAS option enables the orintine of statistics 
from data hase structure records that show. the 


layout of records, index tables, and list 
Structures included in this data base. Since 
there 1$ a one to one correspcndence between. 
structures and files» information cn files is 


included with the structure information. 


tablesize>. 


when enabled» this option causes a Limit to be put 


on the maximum size of all indexed sequentiat— and 
indexed random sets in this data base. This limit 


May be overridden by an explicit MAXENTRIES 


declaration for any individual sets but serves as 
a bound for the defautt Ccalcutatior for any set 


not explicitly specified. The <max tablesize> is 


a required parameters and indicates the maximum 
size in disk seaments that the tables are allowed 
to attain. The maximum value for <max tablesize> 
1s 455 the default vatue is 20. 


Used in conjunction with "REQKGANIZE™ to specify 

Cape as the communication media for the data hase 
reorganization programs.  Cefault wedia for these 
orograms is a queue file. | 
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UPDATE <data base name> 


VERS TOGNCHECK 


DASDL GPILONS 


This option specifies that the data base source 
description be compared to and superceae the 
existing data base description. UPDATE may be 
used in conjunction with the REORGANIZE option or 
by itself. When used aloner the new description 
of the data tase may specify new structures or 
exclude existing structures as long as_ these 


changes do not cause any restructuring of the 


continuing data hase. The <data base name> is an 

optional parameters and specifies the name cf an 
existing data tase which 18 to be updated.  =If 
omitted» the data base name associated with this 


DASDL compile is assumed. Use of the data hbase 


name parameter has no effect on the names of the 
data base files being created. This options i f 
specified» must be the tast option to appear on a 
compiler control carc image. 


This option causes the run- time verification that 


the version (date and time of compile). associated | 


with the CCS8OL tihbrary files of any application. 
program attempting to access this data base is 
equal to that associated with the structures in. 
the data hase ttself. The default setting for. 


this option is enabled. 


Unless otherwise specified» atl options default to disabled and 


do not allow parameters. 


cogoL 


This option causes the DASDL compiler to check for 
COBOL res2rved words which may occur as 


identifiers in the DASDL source. This prevents 
syntax errors from occuring in the CCQBOL tLtbrary 
files generated by this compile. | | 


—=COoBOLIs <logical data base na@we>. 


‘This option causes DASOL to generate CCB8OL Library 


files on disk for the logical data case specified. 


If <tlogicat data base name> is omitted» then the 


name of the physical data base is assumed. The. 
COBOL1B option is set by default for the physical | 


med 
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CODE 


DEBUG 


DELETE 


DOUBLE 


INCLNEH - 


data taser but reset for all togicat data bases. 


This option causes the DASDL compiler to print 


Information about the DASOL generated code. Two 
tables are listed. 


The first table tists each code segment and its 
$1Ze. 


The second table lists each structure by name» and > 
for each of the up to 6 kinds of coae_ that could | 
be generated for a structure, the segment numter 
of the segment that contains that particular type 
of code. - _— | 


This is intended tobe used in conjunction with 


SYSTEM/MARKSEGS. 


This option causes DASDL to include reorganization 
control information mn the output . tisting 
generated ty this compite. This option = is 
intended for development use only. | 


When enabled» this option causes the ~—PASOL 
compiter to discard source Images from the 
secondary input file (C*"SOURCE™) untit disabled. 
It must appear on a Source tmage in the primary 
input file ("CARDS")»s and has no effect if "MERGE" 
has not been enabled. The normal merging process 
wilt not ce altered, but att source inages 
Cincluding OASOL compiter controt options) will be 
discarded as they are read from the secondary > 
file. These source images wilt not be listed or 
carried forward into a new source file. 


When enabled» causes the DASOL output Listing to 
be double spaced. 4 | 


This option» when enabled» causes any source 
images processed as a result of the "INCLUDE 
option tc be included in the new source file 
C™NEWSOURCE™) should the "NEW" option be enabled. 
If "NEW" is not enableds this option has no 
effect. | | ee 


SC Ee ee ee te ee eM Ce eT Ma eee ae 


BURROUGHS CORPORATION : COMPANY CONF ICENTIAL 


COMPUTER SYSTEMS GROUP 7 B18NN/B17NN PASOL 
SANTA BARBARA PLANT ~P.S. 2219 0433 REV B 


INCLUDE <file-td> 


LIST 


LISTS 


LISTINCL 


PAGE 


When enableds this option causes DASDL to suspend 
the normal sequence of processing source ' images 


and accept input from the file specified by 
<filer-id> until such tnput is exhausted. Normal 


compilation is then resumed. The <file-id> is a 
required parameter» andis in the normat file 
identifier format cf <pack>/<mfid>/<fid>. This 
option», if specified» must be the last option to 
appear on the compiler control card image» and may 
not appear on a source image within a_ file 
processed via the “INCLUDE” option. | 


This option causes a tisting of all source images 
and permanent DASOL compiler option card images to 


be included in the output tisting for this 
comptle. The default setting for this option is 


enabled. 


This option causes a tisting of alt temporary 
DASDL coapiter control card tmages to be included 
in the output listing for this compile. If the 


LIST option is disabled» LISTS has no effect. 


When enabled» this option causes the inclusicn of 
atl source images processed via the “INCLUDE” 
option in the output listing for this compile. If 
the LIST option is disabled, LISTINCL has ‘no 
effect. 7 


When encountered» this option immediately causes a 


page advance to be ptaced in the output listing 


for this compile. 


This option causes the DASDL compiler to check the 
database cescription for RPG compatibilitys 
respecting tdentifter size and subscripting. 
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RPGLIB <togicatl data base name> 


This option causes ODMASDL to generate the RPG 
tibrary files on disk for the logicat data base 
specified. If <togtical data base name> is 
omitted, then the name of the physical data base 
1s assumed.» The RPGLIB option is reset by default 
for the physical data base and all togical data 
bases. 


SEQ or SEQUENCE 


This optton»e when enabled» causes the ODASDOL 
compiler to assign new sequence numbers to the 
source language card images accepted for input. 
This option assigns the Current Sequence Sase (see 
DASCL option values) to the current source image» 
and increments the Current Sequence Base by the 


Current Sequence increment (see. DASOL option. 
values). | | | 
SINGLE When enabled» this option causes the compiler 


output listing to be single spaced. This option 
defaults to enabled. | | . 


STANCARD 7 This option causes the DASDL compiler to enforce 
| syntax rules as described by the Burroughs CASOL 

SUPPRESS This option causes the DASDL compiter to suppress 
the inclusicn cf warning messages in the output 


listing for thts compile. This optton perforas 
the sane function as “WARNSUPR”. 7 


VOID <seq-no> 


This options when enabled» causes all input images 
in the secondary source file ("SGURCE") to be 
discarded until <seq-no> has been exceeded by a 
sequence nuster in the secondary source file. The 
<seqzno> is an optional parameter and must be &@ 
digits in length. If omitted» only the present. 
card image will be discarded. | | 


feat 
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WARNSUPR When enablec>, this option causes the DA SDL 
| | compiler to surpress inclusion of warning messages 
in the output listing for this compile. See 
"SUPPRESS", | 


DASDL OPTION VALUES 


These values are used by the DASDL compiler to control 
resequencings» and may appear anywhere on a compiler contrcl card 
image. They have no effect if the "SEQ" option is not enabled. 


Current Sequence Base 


This is a 1 to 8 character string of digits. 
signifying the current base sequence number from 
which resequencing wilt take place. The default 
value for this entity is "ANNAN ANON, 


Current Sequence Increment 


This is a character string comprised of a. Ten 
character followed by 1 to @ digits signifying the 
current increment to be used in resequencing. The 
default setting for this entity is "#1609", 


— spaces may optionally appear between the 4? | 


Character ard the sequence increment. 
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CAKOS 


CCROL.LIB 


DMS.-DICT 


CMS.~OLC.OCICT 


ERROR.LINE 


GUARCFILE - 
LIBRARY 


LINE 


NEWSCURCE 


REORG.CODE 


REORG.FILE 


—RPG.LIB. 
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DASUL FILES 


This ais the primary source file for the DASDL 
compiler. It is the first file to be reads and may 
contain the entire set of source images to te 


(Processed. Optionally» Cif "MERGE" is enabled) it 


may contain patches to be applied to the Secondacy 
Input file pe URCE 2% | 


| The COBOL iibeary files created by oasot are 
written serially to this file. 


This file is the data base dicticnary associated 


with the data base uae be created a this. DASDL. 


compile. 


This file is an existing data base dictionary Jeet 
will be used by the DASCL espe tc create a new 
data base dictionary. 


This is the error message output file used in 
conjunction with compiles via CANDE. When a 
compile is initiated from a terminal through CANDE>» 


(or DASDL is executed with SWl1 = ti» alt error 
messages will te curoed to this ee: ee 


This i858 a serial input file containing security 
access restrictions for the data base. 


This file contains source statement images to be 


processed via the “"INCLUGE" option. 


This is the output tisting file» containing a list 
of processed source images. Its contents are. 


controlled via the “LIST"» "LISTS"» and "LISTINCL®™ 


options. 


This 1s the outout symbolic files a file eentareenc 
those source images selected by DASDL in. accordance 


with the "NEW" and “"TNCLNEW" options. 


This is an sone file used for the chestien cf the 
PEQRG.READER and REORG eWRITER code files. 


This is an input file ee for the creation of the 


REORG.REACER and FEORG. WRITER code files. 


Pai RPG library files created by DASDL are written 
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SCL.FILE 


SOURCE 


serially to this file. 


This is a random output file used for the creation. 


of the data files for the data hase being 


processed. — 


This file is the secondary. input file» which 
contains previously stored DASOL Source images. It 
1s not used untess the "MERGE" option is enabled. — 
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